Release 10.1A: OpenEdge Development:
Progress Dynamics Advanced Development

Creating a new manager type

Each new manager must first have a type.

To create a new Manager Type:

Select Manager Type Control from the Administration window Session menu, as shown:



Choose Add to create a new control. The Manager Type Maintenance window appears, as shown:



The Manager Type Maintenance window has the following fields:

Manager Type Code — A single-word identifier used as a key for retrieving the manager’s handle and to identify it to the Session Manager.
Manager Type Name — Any meaningful descriptive string for the manager, which appears in messages referring to the manager. By convention, this is just the Manager Type Code with spaces, as appropriate.
Static Handle — The built-in Progress Dynamics managers have global variables defined for them in the file src/adm2/globals.i. Unless your new manager is going to be accessed with great frequency at different places within your application, which might possibly make it noticeably faster to have immediate access to the handle from anywhere, you should not add a new global handle for it. This would require you to edit globals.i and then recompile every procedure in the entire framework and in your application to provide access to it. The handles that are already in globals.i are there for efficiency for the basic framework managers (and not even all of those). Instead, you can use the getManagerHandle function in the Session Manager to retrieve the handle of your manager from anywhere in your application. In this case you set the Static Handle entry to No Static Handle.
System Owned — This toggle box restricts modifications to the manager to those users with System privilege.
Write to Config — If you want the manager information to be written out to the XML configuration file that holds all the session information, then check the Write to Config toggle box on. If you want to associate the manager with one or more session types and have it automatically started for you when those sessions are started, then you must check Write to Config on. If you intend to access the manager only programmatically once your application session has already started, then you can leave it off.
Manager Narration — This field is for any explanation of the manager’s purpose.
Choose Save when you have entered your information, and return to the Manager Type Control window to see the new manager in the list with all the other managers, as shown: